home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / gfx / xfig_sup.lha / xfig_support / doc / fig2dev.doc next >
Text File  |  1995-09-01  |  17KB  |  411 lines
  1. NAME
  2.        fig2dev  -  translates  Fig  code to various graphics lan-
  3.        guages
  4.  
  5. SYNOPSIS
  6.        fig2dev -L language [ -m mag ] [ -f font ] [ -s fsize ]  [
  7.        other options ] [ fig-file [ out-file ] ]
  8.  
  9. DESCRIPTION
  10.        Fig2dev translates fig code in the named fig-file into the
  11.        specified graphics language and  puts  them  in  out-file.
  12.        The  default  fig-file and out-file are standard input and
  13.        standard output, respectively
  14.  
  15.        Fig (Facility for Interactive Generation of figures) is  a
  16.        screen-oriented  tool  which  allows  the user to draw and
  17.        manipulate objects interactively.  Various versions of Fig
  18.        run  under  the  Suntools/Sunview  window  environment and
  19.        under version 11 of the X Windows System.  Fig2dev is com-
  20.        patible with Fig versions 1.3, 1.4, 2.0, 2.1, 3.0 and 3.1.
  21.  
  22. OPTIONS
  23.        -L     Set the output graphics language.  Valid  languages
  24.               are box, epic, eepic, eepicemu, ibmgl, latex, null,
  25.               pic, pictex, ps, pstex, pstex_t, textyl, mf  (META-
  26.               FONT) and tpic.
  27.  
  28.        -m     Set  the  magnification at which the figure is ren-
  29.               dered to mag.  The default is 1.0.
  30.  
  31.        -f     Set the default font used for text objects to font.
  32.               The  default  is  Roman;  the format of this option
  33.               depends on the graphics language in use.   In  TeX-
  34.               based  languages,  the font is the base of the name
  35.               given in lfonts.tex, for instance "cmr" for  Roman,
  36.               or  "tt"  for  teletype.   In PostScript, it is any
  37.               font name known to the printer or interpreter.
  38.  
  39.        -s     Set the default font  size  (in  points)  for  text
  40.               objects  to fsize.  The default is 11*mag, and thus
  41.               is scaled by the -m option.  If there is  no  scal-
  42.               ing, the default font is eleven point Roman."
  43.  
  44.        -V     Print the program version number only.
  45.  
  46.        other options
  47.               The  other  options  are  specific to the choice of
  48.               graphics language, as described below.
  49.  
  50.            Release 3.1(.2) (Protocol 3.1) Aug 16, 1995          1
  51.  
  52. EPIC OPTIONS
  53.        EPIC is an enhancement to LaTeX picture  drawing  environ-
  54.        ment.   It  was  developed by Sunil Podar of Department of
  55.        Computer Science in S.U.N.Y at Stony Brook.
  56.  
  57.        EEPIC is an extension to EPIC and  LaTeX  picture  drawing
  58.        environment  which uses tpic specials as a graphics mecha-
  59.        nism.  It was written by Conrad Kwok of Division  of  Com-
  60.        puter Science at University of California, Davis.
  61.  
  62.        EEPIC-EMU is an EEPIC emulation package which does not use
  63.        tpic specials.
  64.  
  65.        -l     Use "\thicklines" when width of the line  is  wider
  66.               than lwidth.  The default is 2.
  67.  
  68.        -v     Include comments in the output file.
  69.  
  70.        -P     Generate a complete LaTeX file. In other words, the
  71.               output file can be formatted without requiring  any
  72.               changes. The additional text inserted in the begin-
  73.               ning and at the end of the file  is  controlled  by
  74.               the configuration parameter "Preamble" and "Postam-
  75.               ble".
  76.  
  77.        -S     Set the scale to  which  the  figure  is  rendered.
  78.               This  option  automatically  sets the magnification
  79.               and size to scale / 12 and scale respectively.
  80.  
  81.        -W     Enable variable line width
  82.  
  83.        -w     Disable variable  line  width.  Only  "\thicklines"
  84.               and/or  "\thinlines"  commands will be generated in
  85.               the output file.
  86.  
  87.        When variable line width option is  enabled,  "\thinlines"
  88.        command  is  still  used  when  line  width  is  less than
  89.        LineThick. One potential problem  is  that  the  width  of
  90.        "\thinlines"  is  0.4pt  but the resolution of Fig is 1/80
  91.        inch (approx. 1pt). If LineThick is set to 2, normal lines
  92.        will  be drawn in 0.4pt wide lines but the next line width
  93.        is already 2pt. One possible solution is to set  LineThick
  94.        to  1  and set the width of the those lines you want to be
  95.        drawn in "\thinlines"  to 0.
  96.  
  97.        Due to this  problem,  Variable  line  width  VarWidth  is
  98.        defaulted to be false.
  99.  
  100. IBM-GL OPTIONS
  101.        IBM-GL (International Business Machines Graphics Language)
  102.        is compatible with HP-GL  (Hewlett-Packard  Graphics  Lan-
  103.        guage).
  104.  
  105.            Release 3.1(.2) (Protocol 3.1) Aug 16, 1995          2
  106.  
  107.        -a     Select ISO A4 (ANSI A) paper size if the default is
  108.               ANSI A (ISO A4) paper size.
  109.  
  110.        -c     Generate instructions for an IBM 6180 Color Plotter
  111.               with  (without)  an  IBM  Graphics Enhancement Car-
  112.               tridge (IBM-GEC).
  113.  
  114.        -d     Restrict plotting to  a  rectangular  area  of  the
  115.               plotter paper which has a lower left hand corner at
  116.               (xll,yll)  and  a  upper  right  hand   corner   at
  117.               (xur,yur).  All four numbers are in inches and fol-
  118.               low -d in a comma-sparated list - xll,yll,xur,yur -
  119.               with no spaces between them.
  120.  
  121.        -f     Load  text  character specifications from the table
  122.               in the fonts file.  The table must have 36  entries
  123.               -  one  for  each  font plus a default.  Each entry
  124.               consists of 5 numbers which specify the  1.)  stan-
  125.               dard  character  set  (0  - 4, 6 - 9, 30 - 39), 2.)
  126.               alternate character set (0 - 4, 6 - 9,  30  -  39),
  127.               3.)  character slant angle (degrees), 4.) character
  128.               width scale factor and 5.) character  height  scale
  129.               factor.
  130.  
  131.        -l     Load  area fill line patterns from the table in the
  132.               patterns file.  The table must have  21  entries  -
  133.               one for each of the area fill patterns.  Each entry
  134.               consists of 5 numbers which specify the 1.) pattern
  135.               number  (-1  - 6), 2.) pattern length (inches), 3.)
  136.               fill type (1 - 5), 4.) fill  spacing  (inches)  and
  137.               5.) fill angle (degrees).
  138.  
  139.        -m     The  magnification  may appear as the first element
  140.               in a comma sepatated list - mag,x0,y0 -  where  the
  141.               second  and  third  parameters specify an offset in
  142.               inches.
  143.  
  144.        -p     Load plotter pen specifications from the  table  in
  145.               the pens file.  The table must have 9 entries - one
  146.               for each color plus a default.  Each entry consists
  147.               of  2 numbers which specify the 1.) pen number (1 -
  148.               8) and 2.) pen thickness (millimeters).
  149.  
  150.        -P     Rotate the figure to portrait mode. The default  is
  151.               landscape mode.
  152.  
  153.        -S     Set the pen speed to speed (centimeters/second).
  154.  
  155.        -v     Plot  the  figure  upside-down  in portrait mode or
  156.               backwards in landscape mode.  This  allows  you  to
  157.               write on the top surface of overhead transparencies
  158.               without disturbing the plotter ink  on  the  bottom
  159.               surface.
  160.  
  161.            Release 3.1(.2) (Protocol 3.1) Aug 16, 1995          3
  162.  
  163.        Fig2dev  may  be  installed  with  either ANSI A or ISO A4
  164.        default paper size.  The -a option selects  the  alternate
  165.        paper  size.   Fig2dev  does not fill closed splines.  The
  166.        IBM-GEC is required to fill other polygons.   Fig2dev  may
  167.        be  installed  for  plotters  with or without the IBM-GEC.
  168.        The -c option selects the alternate instruction set.
  169.  
  170. LATEX OPTIONS
  171.        -l     Sets the threshold between  LaTeX  thin  and  thick
  172.               lines  to  lwidth  pixels.  LaTeX supports only two
  173.               different line width: \thinlines  and  \thicklines.
  174.               Lines of width greater than lwidth pixels are drawn
  175.               as \thicklines.  Also affects the size of  dots  in
  176.               dotted line style.  The default is 1.
  177.  
  178.        -d     Set a separate magnification for the length of line
  179.               dashes to dmag.
  180.  
  181.        -v     Verbose mode.
  182.  
  183.        LaTeX cannot accurately represent all the graphics objects
  184.        which  can be described by Fig.  For example, the possible
  185.        slopes which lines may have are  limited.   Some  objects,
  186.        such  as spline curves, cannot be drawn at all.  Fig2latex
  187.        chooses the closest possible line slope, and prints  error
  188.        messages when objects cannot be drawn accurately
  189.  
  190. PIC OPTIONS
  191.        -p     Enables the use of certain PIC extensions which are
  192.               known to work with the groff package; compatibility
  193.               with DWB PIC is unknown.  The extensions enabled by
  194.               each option are:
  195.  
  196.        arc    Allow ARC_BOX i.e. use rounded corners
  197.  
  198.        line   Use the 'line_thickness' value
  199.  
  200.        fill   Allow ellipses to be filled
  201.  
  202.        all    Use all of the above
  203.  
  204.        psfont Don't convert Postscript fonts generic type (useful
  205.               for files going to be Ditroff'ed for and printed on
  206.               PS printer). DWB-compatible.
  207.  
  208.        allps  Use all of the above (i.e. "all" + "psfont")
  209.  
  210. PICTEX OUTPUT
  211.        In order to include PiCTeX pictures into a document, it is
  212.        necessary to load the PiCTeX macros.
  213.  
  214.            Release 3.1(.2) (Protocol 3.1) Aug 16, 1995          4
  215.  
  216.        PiCTeX  uses  TeX  integer register arithmetic to generate
  217.        curves, and so it is very slow.  PiCTeX  draws  curves  by
  218.        \put-ing  the  psymbol repeatedly, and so requires a large
  219.        amount of TeX's internal memory, and generates  large  DVI
  220.        files.  The size of TeX's memory limits the number of plot
  221.        symbols in a picture.  As a result,  it  is  best  to  use
  222.        PiCTeX to generate small pictures.
  223.  
  224. POSTSCRIPT OPTIONS
  225.        With  PostScript, Fig can be used to create large posters.
  226.        The figure will be  created  by  printing  multiple  pages
  227.        which can be glued together.  Simply specify the -M option
  228.        to produce a multi-page output.  Due to memory limitations
  229.        of  most laser printers, the figure should not be too com-
  230.        plicated. Great for text with very big letters.
  231.  
  232.        Text can now include  various  ISO-character  codes  above
  233.        0x7f,  which is useful for language specific characters to
  234.        be printed directly.  Not all  ISO-characters  are  imple-
  235.        mented.
  236.  
  237.        Color  support:  Colored  objects  created  by  Fig can be
  238.        printed on a color postscript printer. There are 32  stan-
  239.        dard  colors:  black,  yellow, white, gold, five shades of
  240.        blue, four shades of green,  four  shades  of  cyan,  four
  241.        shades  of  red,  five  shades  of magenta, four shades of
  242.        brown, and four shades of pink.  In addition there may  be
  243.        user-defined  colors  in the file.  See the xfig FORMAT3.1
  244.        file for the definition of these colors.  On a  monochrome
  245.        printer,  colored  objects  will  be mapped into different
  246.        grayscales by the printer.   Filled  objects  are  printed
  247.        using  the  given  area  fill  and  color.   There  are 21
  248.        "shades" going from black to full saturation of  the  fill
  249.        color,  and  21  more  "tints" from full saturation + 1 to
  250.        white.  In addition, there are 16 patterns such as bricks,
  251.        diagonal lines, crosshatch, etc.
  252.  
  253.        -c     option centers the figure on the page.  The center-
  254.               ing may not be accurate if there are texts  in  the
  255.               fig_file that extends too far to the right of other
  256.               objects.
  257.  
  258.        -e     option puts the figure against the edge  (not  cen-
  259.               tered) of the page.
  260.  
  261.        -l dummy_arg
  262.               Generate figure in landscape mode.  The dummy argu-
  263.               ment is ignored, but must  appear  on  the  command
  264.               line  for  reasons  of  compatibility.  This option
  265.               will override the orientation specification in  the
  266.               file (for file versions 3.0 and higher).
  267.  
  268.        -M     Generate  multiple  pages  if  figure  exceeds page
  269.  
  270.            Release 3.1(.2) (Protocol 3.1) Aug 16, 1995          5
  271.  
  272.               size.
  273.  
  274.        -p dummy_arg
  275.               Generate figure in portrait mode.  The dummy  argu-
  276.               ment  is  ignored,  but  must appear on the command
  277.               line for reasons  of  compatibility.   This  option
  278.               will  override the orientation specification in the
  279.               file (for file versions 3.0 and higher).   This  is
  280.               the  default for Fig files of version 2.1 or lower.
  281.  
  282.        -P     indicates that the figure  describes  a  full  page
  283.               which will not necessarily be inserted into a docu-
  284.               ment, but can be sent directly  to  a  PS  printer.
  285.               This ensures that a showpage command is inserted at
  286.               the end of the figure.
  287.  
  288.        -n name
  289.               Set the Title part  of  the  PostScript  output  to
  290.               name.   This  is  useful  when the input to fig2dev
  291.               comes from standard input.
  292.  
  293.        -x offset
  294.               shift the figure in the X direction by offset units
  295.               (1/72 inch).  A negative value shifts the figure to
  296.               the left and a positive value to the right.
  297.  
  298.        -y offset
  299.               shift the figure in the Y direction by offset units
  300.               (1/72 inch).  A negative value shifts the figure up
  301.               and a positive value down.
  302.  
  303.        -z pagesize
  304.               Sets the pagesize. Available page sizes  are  "Let-
  305.               ter"  (8.5"  x  11"),  "Legal" (11" x 14") "Ledger"
  306.               (11" x 17"), "A4" (21cm x 29.7cm), and "B5" (18.2cm
  307.               x 25.7cm).
  308.  
  309. PSTEX OPTIONS
  310.        The    pstex  language is a variant of ps which suppresses
  311.               formatted (special) text.  The pstex_t language has
  312.               the complementary behavior: it generates only LaTeX
  313.               commands necessary to position special text, and to
  314.               overlay  the PostScript file generated using pstex.
  315.               These two drivers can be used to generate a  figure
  316.               which combines the flexibility of PostScript graph-
  317.               ics with LaTeX text formatting of special text.
  318.  
  319.        The    pstex_t option -p file specifies the  name  of  the
  320.               PostScript  file to be overlaid.  If not set or its
  321.               value is null then no PS file will be inserted.
  322.  
  323.            Release 3.1(.2) (Protocol 3.1) Aug 16, 1995          6
  324.  
  325. TEXTYL OPTIONS
  326.        There are no TeXtyl-specific options.
  327.  
  328. METAFONT OPTIONS
  329.        -C code
  330.               specifies the starting METAFONT font code.
  331.  
  332.        -n name
  333.               specifies the name to use in the output file.
  334.  
  335.        -p pen specifies the size of the METAFONT pen.
  336.  
  337.        -t top specifies the top of the whole coordinate system.
  338.  
  339.        -x xneg
  340.               specifies the minimum x  coordinate  value  of  the
  341.               figure (inches).
  342.  
  343.        -y yneg
  344.               specifies  the  minumum  y  coordinate value of the
  345.               figure (inches).
  346.  
  347.        -X xpos
  348.               specifies the maximum x  coordinate  value  of  the
  349.               figure (inches).
  350.  
  351.        -Y ypos
  352.               specifies  the  maximum  y  coordinate value of the
  353.               figure (inches).
  354.  
  355. TPIC OPTIONS
  356.        There are no tpic-specific options.
  357.  
  358. SEE ALSO
  359.        [x]fig(1), pic(1) pic2fig(1), transfig(1)
  360.  
  361. COPYRIGHT
  362.        Copyright (c) 1985 Supoj Sutantavibul
  363.        Copyright (c) 1991 Micah Beck
  364.  
  365.        Permission to use, copy, modify, distribute, and sell this
  366.        software  and  its documentation for any purpose is hereby
  367.        granted without fee, provided  that  the  above  copyright
  368.        notice  appear  in all copies and that both that copyright
  369.        notice and this permission  notice  appear  in  supporting
  370.        documentation.  The  authors make no representations about
  371.        the suitability of this software for any purpose.   It  is
  372.        provided "as is" without express or implied warranty.
  373.  
  374.        THE  AUTHORS  DISCLAIM  ALL WARRANTIES WITH REGARD TO THIS
  375.  
  376.            Release 3.1(.2) (Protocol 3.1) Aug 16, 1995          7
  377.  
  378.        SOFTWARE,  INCLUDING  ALL  IMPLIED  WARRANTIES   OF   MER-
  379.        CHANTABILITY AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE
  380.        LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL  DAMAGES
  381.        OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA
  382.        OR PROFITS, WHETHER IN AN ACTION OF  CONTRACT,  NEGLIGENCE
  383.        OR  OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
  384.        WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  385.  
  386. AUTHORS
  387.        Micah Beck
  388.        Cornell University
  389.        Sept 28 1990
  390.  
  391.        and Frank Schmuck (then of Cornell University)
  392.        and Conrad Kwok (then of U.C. Davis).
  393.  
  394.        drivers contributed by
  395.        Jose Alberto Fernandez R. (U. of Maryland)
  396.        and Gary Beihl (MCC)
  397.  
  398.        Color support, ISO-character encoding and  poster  support
  399.        by
  400.        Herbert Bauer (heb@regent.e-technik.tu-muenchen.de)
  401.  
  402.        Modified from f2p (fig to PIC), by the author of Fig
  403.        Supoj Sutanthavibul (supoj@sally.utexas.edu)
  404.        University of Texas at Austin.
  405.  
  406.        MetaFont driver by
  407.        Anthony Starks (ajs@merck.com)
  408.  
  409.            Release 3.1(.2) (Protocol 3.1) Aug 16, 1995          8
  410.  
  411.